home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glteximage1d.z / glteximage1d
Encoding:
Text File  |  2002-10-03  |  57.9 KB  |  599 lines
  1.  
  2.  
  3.  
  4. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD - specify a one-dimensional texture image
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD( GLenum _t_a_r_g_e_t,
  14.                         GLint _l_e_v_e_l,
  15.                         GLint _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  16.                         GLsizei _w_i_d_t_h,
  17.                         GLint _b_o_r_d_e_r,
  18.                         GLenum _f_o_r_m_a_t,
  19.                         GLenum _t_y_p_e,
  20.                         const GLvoid *_p_i_x_e_l_s )
  21.  
  22.  
  23. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  24.      _t_a_r_g_e_t          Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD or
  25.                      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD.
  26.  
  27.      _l_e_v_e_l           Specifies the level-of-detail number.  Level 0 is the
  28.                      base image level.  Level _n is the _nth mipmap reduction
  29.                      image.
  30.  
  31.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  Specifies the number of color components in the texture.
  32.                      Must be 1, 2, 3, or 4, or one of the following symbolic
  33.                      constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222,
  34.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888,
  35.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  36.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222,
  37.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444,
  38.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666,
  39.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888,
  40.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____RRRR3333____GGGG3333____BBBB2222,
  41.                      GGGGLLLL____RRRRGGGGBBBB4444, GGGGLLLL____RRRRGGGGBBBB5555, GGGGLLLL____RRRRGGGGBBBB8888, GGGGLLLL____RRRRGGGGBBBB11110000, GGGGLLLL____RRRRGGGGBBBB11112222, GGGGLLLL____RRRRGGGGBBBB11116666,
  42.                      GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA4444, GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111, GGGGLLLL____RRRRGGGGBBBBAAAA8888,
  43.                      GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA11112222, GGGGLLLL____RRRRGGGGBBBBAAAA11116666, GGGGLLLL____DDDDUUUUAAAALLLL____AAAALLLLPPPPHHHHAAAA4444____SSSSGGGGIIIISSSS,
  44.                      GGGGLLLL____DDDDUUUUAAAALLLL____AAAALLLLPPPPHHHHAAAA8888____SSSSGGGGIIIISSSS, GGGGLLLL____DDDDUUUUAAAALLLL____AAAALLLLPPPPHHHHAAAA11112222____SSSSGGGGIIIISSSS,
  45.                      GGGGLLLL____DDDDUUUUAAAALLLL____AAAALLLLPPPPHHHHAAAA11116666____SSSSGGGGIIIISSSS, GGGGLLLL____DDDDUUUUAAAALLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____SSSSGGGGIIIISSSS,
  46.                      GGGGLLLL____DDDDUUUUAAAALLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____SSSSGGGGIIIISSSS, GGGGLLLL____DDDDUUUUAAAALLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____SSSSGGGGIIIISSSS,
  47.                      GGGGLLLL____DDDDUUUUAAAALLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____SSSSGGGGIIIISSSS, GGGGLLLL____DDDDUUUUAAAALLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444____SSSSGGGGIIIISSSS,
  48.                      GGGGLLLL____DDDDUUUUAAAALLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888____SSSSGGGGIIIISSSS, GGGGLLLL____DDDDUUUUAAAALLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222____SSSSGGGGIIIISSSS,
  49.                      GGGGLLLL____DDDDUUUUAAAALLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666____SSSSGGGGIIIISSSS, GGGGLLLL____DDDDUUUUAAAALLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA4444____SSSSGGGGIIIISSSS,
  50.                      GGGGLLLL____DDDDUUUUAAAALLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA8888____SSSSGGGGIIIISSSS, GGGGLLLL____QQQQUUUUAAAADDDD____AAAALLLLPPPPHHHHAAAA4444____SSSSGGGGIIIISSSS,
  51.                      GGGGLLLL____QQQQUUUUAAAADDDD____AAAALLLLPPPPHHHHAAAA8888____SSSSGGGGIIIISSSS, GGGGLLLL____QQQQUUUUAAAADDDD____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____SSSSGGGGIIIISSSS,
  52.                      GGGGLLLL____QQQQUUUUAAAADDDD____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____SSSSGGGGIIIISSSS, GGGGLLLL____QQQQUUUUAAAADDDD____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444____SSSSGGGGIIIISSSS, or
  53.                      GGGGLLLL____QQQQUUUUAAAADDDD____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888____SSSSGGGGIIIISSSS.
  54.  
  55.      _w_i_d_t_h           Specifies the width of the texture image.  Must be
  56.                       n
  57.                      2 +2(border) for some integer n. All implementations
  58.                      support texture images that are at least 64 texels wide.
  59.                      The height of the 1D texture image is 1.
  60.  
  61.  
  62.  
  63.  
  64.                                                                         PPPPaaaaggggeeee 1111
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  72.  
  73.  
  74.  
  75.      _b_o_r_d_e_r          Specifies the width of the border.  Must be either 0 or
  76.                      1.
  77.  
  78.      _f_o_r_m_a_t          Specifies the format of the pixel data.  The following
  79.                      symbolic values are accepted:  GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX, GGGGLLLL____RRRREEEEDDDD,
  80.                      GGGGLLLL____GGGGRRRREEEEEEEENNNN, GGGGLLLL____BBBBLLLLUUUUEEEE, GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____BBBBGGGGRRRR, GGGGLLLL____RRRRGGGGBBBBAAAA,
  81.                      GGGGLLLL____BBBBGGGGRRRRAAAA, GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, and
  82.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.
  83.  
  84.      _t_y_p_e            Specifies the data type of the pixel data.  The following
  85.                      symbolic values are accepted:  GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____BBBBYYYYTTTTEEEE,
  86.                      GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT,
  87.                      GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
  88.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
  89.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,
  90.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
  91.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
  92.                      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222,
  93.                      and GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV.
  94.  
  95.      _p_i_x_e_l_s          Specifies a pointer to the image data in memory.
  96.  
  97. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  98.      Texturing maps a portion of a specified texture image onto each graphical
  99.      primitive for which texturing is enabled.  To enable and disable one-
  100.      dimensional texturing, call ggggllllEEEEnnnnaaaabbbblllleeee and ggggllllDDDDiiiissssaaaabbbblllleeee with argument
  101.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD.
  102.  
  103.      Texture images are defined with ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD.  The arguments describe the
  104.      parameters of the texture image, such as width, width of the border,
  105.      level-of-detail number (see ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr), and the internal resolution
  106.      and format used to store the image.  The last three arguments describe
  107.      how the image is represented in memory; they are identical to the pixel
  108.      formats used for ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  109.  
  110.      If _t_a_r_g_e_t is GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, no data is read from _p_i_x_e_l_s, but all of
  111.      the texture image state is recalculated, checked for consistency, and
  112.      checked against the implementation's capabilities.  If the implementation
  113.      cannot handle a texture of the requested texture size, it sets all of the
  114.      image state to 0, but does not generate an error (see ggggllllGGGGeeeettttEEEErrrrrrrroooorrrr). To
  115.      query for an entire mipmap array, use an image array level greater than
  116.      or equal to 1.
  117.  
  118.      If _t_a_r_g_e_t is GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, data is read from _p_i_x_e_l_s as a sequence of
  119.      signed or unsigned bytes, shorts, or longs, or single-precision
  120.      floating-point values, depending on _t_y_p_e. These values are grouped into
  121.      sets of one, two, three, or four values, depending on _f_o_r_m_a_t, to form
  122.      elements. If _t_y_p_e is GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP, the data is considered as a string of
  123.      unsigned bytes (and _f_o_r_m_a_t must be GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX). Each data byte is
  124.      treated as eight 1-bit elements, with bit ordering determined by
  125.      GGGGLLLL____UUUUNNNNPPPPAAAACCCCKKKK____LLLLSSSSBBBB____FFFFIIIIRRRRSSSSTTTT (see ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee).
  126.  
  127.  
  128.  
  129.  
  130.                                                                         PPPPaaaaggggeeee 2222
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  138.  
  139.  
  140.  
  141.      The first element corresponds to the left end of the texture array.
  142.      Subsequent elements progress left-to-right through the remaining texels
  143.      in the texture array.  The final element corresponds to the right end of
  144.      the texture array.
  145.  
  146.      _f_o_r_m_a_t determines the composition of each element in _p_i_x_e_l_s.  It can
  147.      assume one of eleven symbolic values:
  148.  
  149.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX
  150.                Each element is a single value, a color index. The GL converts
  151.                it to fixed point (with an unspecified number of zero bits to
  152.                the right of the binary point), shifted left or right depending
  153.                on the value and sign of GGGGLLLL____IIIINNNNDDDDEEEEXXXX____SSSSHHHHIIIIFFFFTTTT, and added to
  154.                GGGGLLLL____IIIINNNNDDDDEEEEXXXX____OOOOFFFFFFFFSSSSEEEETTTT (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr). The resulting index is
  155.                converted to a set of color components using the
  156.                GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____RRRR, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____GGGG, GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____BBBB,
  157.                and GGGGLLLL____PPPPIIIIXXXXEEEELLLL____MMMMAAAAPPPP____IIII____TTTTOOOO____AAAA tables, and clamped to the range [0,1].
  158.  
  159.      GGGGLLLL____RRRREEEEDDDD    Each element is a single red component. The GL converts it to
  160.                floating point and assembles it into an RGBA element by
  161.                attaching 0 for green and blue, and 1 for alpha. Each component
  162.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  163.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS. and clamped to the range [0,1]
  164.                (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  165.  
  166.      GGGGLLLL____GGGGRRRREEEEEEEENNNN  Each element is a single green component. The GL converts it to
  167.                floating point and assembles it into an RGBA element by
  168.                attaching 0 for red and blue, and 1 for alpha. Each component
  169.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  170.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  171.                (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  172.  
  173.      GGGGLLLL____BBBBLLLLUUUUEEEE   Each element is a single blue component. The GL converts it to
  174.                floating point and assembles it into an RGBA element by
  175.                attaching 0 for red and green, and 1 for alpha. Each component
  176.                is then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added
  177.                to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1]
  178.                (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  179.  
  180.      GGGGLLLL____AAAALLLLPPPPHHHHAAAA  Each element is a single alpha component. The GL converts it to
  181.                floating point and assembles it into an RGBA element by
  182.                attaching 0 for red, green, and blue.  Each component is then
  183.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  184.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  185.                ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  186.  
  187.      GGGGLLLL____RRRRGGGGBBBB
  188.  
  189.      GGGGLLLL____BBBBGGGGRRRR    Each element is an RGB triple.  The GL converts it to floating
  190.                point and assembles it into an RGBA element by attaching 1 for
  191.                alpha.  Each component is then multiplied by the signed scale
  192.                factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and
  193.  
  194.  
  195.  
  196.                                                                         PPPPaaaaggggeeee 3333
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  204.  
  205.  
  206.  
  207.                clamped to the range [0,1] (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  208.  
  209.      GGGGLLLL____RRRRGGGGBBBBAAAA
  210.  
  211.      GGGGLLLL____BBBBGGGGRRRRAAAA
  212.  
  213.      GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT
  214.                Each element contains all four components.  Each component is
  215.                then multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to
  216.                the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  217.                ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  218.  
  219.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE
  220.                Each element is a single luminance value.  The GL converts it
  221.                to floating point, then assembles it into an RGBA element by
  222.                replicating the luminance value three times for red, green, and
  223.                blue and attaching 1 for alpha. Each component is then
  224.                multiplied by the signed scale factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the
  225.                signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and clamped to the range [0,1] (see
  226.                ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  227.  
  228.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA
  229.                Each element is a luminance/alpha pair.  The GL converts it to
  230.                floating point, then assembles it into an RGBA element by
  231.                replicating the luminance value three times for red, green, and
  232.                blue.  Each component is then multiplied by the signed scale
  233.                factor GGGGLLLL____cccc____SSSSCCCCAAAALLLLEEEE, added to the signed bias GGGGLLLL____cccc____BBBBIIIIAAAASSSS, and
  234.                clamped to the range [0,1] (see ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr).
  235.  
  236.      If an application wants to store the texture at a certain resolution or
  237.      in a certain format, it can request the resolution and format with
  238.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t. The GL will choose an internal representation that
  239.      closely approximates that requested by _i_n_t_e_r_n_a_l_f_o_r_m_a_t, but it may not
  240.      match exactly.  (The representations specified by GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE,
  241.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____RRRRGGGGBBBB, and GGGGLLLL____RRRRGGGGBBBBAAAA must match exactly. The numeric
  242.      values 1, 2, 3, and 4 may also be used to specify the preceding
  243.      representations.)
  244.  
  245.      Use the GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD target to try out a resolution and format.
  246.      The implementation will update and recompute its best match for the
  247.      requested storage resolution and format. To query this state, call
  248.      ggggllllGGGGeeeettttTTTTeeeexxxxLLLLeeeevvvveeeellllPPPPaaaarrrraaaammmmeeeetttteeeerrrr.  If the texture cannot be accommodated, texture
  249.      state is set to 0.
  250.  
  251.      A one-component texture image uses only the red component of the RGBA
  252.      color from _p_i_x_e_l_s. A two-component image uses the R and A values.  A
  253.      three-component image uses the R, G, and B values.  A four-component
  254.      image uses all of the RGBA components.
  255.  
  256.      The mapping of components from the canonical RGBA to the internal storage
  257.      formats that begin with GGGGLLLL____DDDDUUUUAAAALLLL____ and GGGGLLLL____QQQQUUUUAAAADDDD____ needs to be clarified.
  258.      There are three cases.  The first case is for the GGGGLLLL____DDDDUUUUAAAALLLL____ formats that
  259.  
  260.  
  261.  
  262.                                                                         PPPPaaaaggggeeee 4444
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  270.  
  271.  
  272.  
  273.      are groups of GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, and GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY.  The R value goes
  274.      to the first group while the A value goes to the second group.  The
  275.      second case is for the GGGGLLLL____DDDDUUUUAAAALLLL____ formats that are groups of
  276.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA.  The R and G values go to the first group while the B
  277.      and A values go to the second group.  The third case is for the GGGGLLLL____QQQQUUUUAAAADDDD____
  278.      formats.  The R value goes to the first group, the G value to the second
  279.      group, the B value to the third group, and the A value to the fourth
  280.      group.
  281.  
  282.      Normally ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD is synchronous: OpenGL executes a ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD
  283.      command in the order it is issued in the OpenGL command stream.  Calling
  284.      ggggllllEEEEnnnnaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX causes subsequent
  285.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD commands to be asynchronous as defined by the SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc
  286.      extension.  An asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD command samples the OpenGL state
  287.      vector at the point in the OpenGL command stream where the command is
  288.      issued, but the results of the command (e.g. availability of texels for
  289.      use in rasterization) do not happen until some unspecified time in the
  290.      future.  In particular, the order of the asynchronous command relative to
  291.      other OpenGL commands issued later in the command stream is undefined.
  292.      An implementation may choose to execute asynchronous commands in parallel
  293.      with the normal command stream or at some convenient time in the future.
  294.  
  295.      Calling ggggllllDDDDiiiissssaaaabbbblllleeee with parameter GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX restores the
  296.      default synchronous behavior for subsequent ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD commands.  It
  297.      does not affect any pending asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands, or wait for
  298.      their completion.
  299.  
  300.      When an asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD command is issued, it is associated
  301.      with the current value of GGGGLLLL____AAAASSSSYYYYNNNNCCCC____MMMMAAAARRRRKKKKEEEERRRR____SSSSGGGGIIIIXXXX as defined by the
  302.      SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc extension.  A program can determine if an asynchronous
  303.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD command has completed by using the ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or
  304.      ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX commands.
  305.  
  306.      There is a maximum number of asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands that can be
  307.      outstanding at any one time, defined by the implementation.  This value
  308.      can be queried with ggggllllGGGGeeeettttIIIInnnntttteeeeggggeeeerrrrvvvv with argument
  309.      GGGGLLLL____MMMMAAAAXXXX____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX.
  310.  
  311. NNNNOOOOTTTTEEEESSSS
  312.      Texturing has no effect in color index mode.
  313.  
  314.      If the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, RGBA elements may also be
  315.      processed by the imaging pipeline.  The following stages may be applied
  316.      to an RGBA color before color component clamping to the range [0, 1]:
  317.  
  318.      1. Color component replacement by the color table specified for
  319.         GGGGLLLL____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled. See ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  320.  
  321.      2. One-dimensional convolution filtering, if enabled. See
  322.         ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                                                         PPPPaaaaggggeeee 5555
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  336.  
  337.  
  338.  
  339.         If a convolution filter changes the __width of the texture (by
  340.         processing with a GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE of GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE, for
  341.                                   n
  342.         example), the _w_i_d_t_h must 2 +2(border), for some integer n, after
  343.         filtering.
  344.  
  345.      3. RGBA components may be multiplied by GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____cccc____SSSSCCCCAAAALLLLEEEE,
  346.         and added to GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____cccc____BBBBIIIIAAAASSSS, if enabled.  See
  347.         ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr.
  348.  
  349.      4. Color component replacement by the color table specified for
  350.         GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled.  See ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  351.  
  352.      5. Transformation by the color matrix.  See ggggllllMMMMaaaattttrrrriiiixxxxMMMMooooddddeeee.
  353.  
  354.      6. RGBA components may be multiplied by GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____SSSSCCCCAAAALLLLEEEE,
  355.         and added to GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____cccc____BBBBIIIIAAAASSSS, if enabled.  See
  356.         ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr.
  357.  
  358.      7. Color component replacement by the color table specified for
  359.         GGGGLLLL____PPPPOOOOSSSSTTTT____CCCCOOOOLLLLOOOORRRR____MMMMAAAATTTTRRRRIIIIXXXX____CCCCOOOOLLLLOOOORRRR____TTTTAAAABBBBLLLLEEEE, if enabled.  See ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee.
  360.  
  361.      The texture image can be represented by the same data formats as the
  362.      pixels in a ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss command, except that GGGGLLLL____SSSSTTTTEEEENNNNCCCCIIIILLLL____IIIINNNNDDDDEEEEXXXX and
  363.      GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT cannot be used.  ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee and ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr
  364.      modes affect texture images in exactly the way they affect ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss.
  365.  
  366.      GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT is part of the EEEEXXXXTTTT____aaaabbbbggggrrrr extension, not part of the core GL
  367.      command set.  If GGGGLLLL____EEEEXXXXTTTT____aaaabbbbggggrrrr is included in the string returned by
  368.      ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS, extension EEEEXXXXTTTT____aaaabbbbggggrrrr
  369.      is supported by the connection.
  370.  
  371.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD may be used only if the GL version is 1.1 or greater.
  372.  
  373.      Internal formats other than 1, 2, 3, or 4 may be used only if the GL
  374.      version is 1.1 or greater.
  375.  
  376.      In GL version 1.1 or greater, _p_i_x_e_l_s may be a null pointer. In this case
  377.      texture memory is allocated to accommodate a texture of width _w_i_d_t_h. You
  378.      can then download subtextures to initialize the texture memory. The image
  379.      is undefined if the program tries to apply an uninitialized portion of
  380.      the texture image to a primitive.
  381.  
  382.      Formats GGGGLLLL____BBBBGGGGRRRR, and GGGGLLLL____BBBBGGGGRRRRAAAA and types GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222,
  383.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555,
  384.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444,
  385.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111,
  386.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888,
  387.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, and
  388.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV are available only if the GL version is
  389.      1.2 or greater.
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                                                         PPPPaaaaggggeeee 6666
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  403.  
  404.  
  405.  
  406. EEEERRRRRRRROOOORRRRSSSS
  407.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD or
  408.      GGGGLLLL____PPPPRRRROOOOXXXXYYYY____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD.
  409.  
  410.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_o_r_m_a_t is not an accepted format
  411.      constant.  Format constants other than GGGGLLLL____SSSSTTTTEEEENNNNCCCCIIIILLLL____IIIINNNNDDDDEEEEXXXX and
  412.      GGGGLLLL____DDDDEEEEPPPPTTTTHHHH____CCCCOOOOMMMMPPPPOOOONNNNEEEENNNNTTTT are accepted.
  413.  
  414.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not a type constant.
  415.  
  416.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is GGGGLLLL____BBBBIIIITTTTMMMMAAAAPPPP and _f_o_r_m_a_t is not
  417.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXX.
  418.  
  419.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
  420.  
  421.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log _m_a_x, where
  422.                                                                    2
  423.      _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  424.  
  425.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not 1, 2, 3, 4, or one
  426.      of the accepted resolution and format symbolic constants.
  427.  
  428.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h is less than 0 or greater than 2 +
  429.                                                              n
  430.      GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or if it cannot be represented as 2  + 2(border) for
  431.      some integer value of _n.
  432.  
  433.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
  434.  
  435.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD is executed between the
  436.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  437.  
  438.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  439.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____3333____3333____2222, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE____2222____3333____3333____RRRREEEEVVVV,
  440.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____6666____5555____RRRREEEEVVVV and _f_o_r_m_a_t is not
  441.      GGGGLLLL____RRRRGGGGBBBB.
  442.  
  443.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_y_p_e is one of
  444.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____4444____4444____4444____4444____RRRREEEEVVVV,
  445.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____5555____5555____5555____1111, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT____1111____5555____5555____5555____RRRREEEEVVVV,
  446.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____8888____8888____8888____8888____RRRREEEEVVVV,
  447.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____11110000____11110000____11110000____2222, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT____2222____11110000____11110000____11110000____RRRREEEEVVVV and _f_o_r_m_a_t
  448.      is not GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____BBBBGGGGRRRRAAAA or GGGGLLLL____AAAABBBBGGGGRRRR____EEEEXXXXTTTT.
  449.  
  450.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if GGGGLLLL____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX is enabled
  451.      and the number of asynchronous ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee commands that have been issued
  452.      but not queried (using ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX or ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX) exceeds
  453.      GGGGLLLL____MMMMAAAAXXXX____AAAASSSSYYYYNNNNCCCC____TTTTEEEEXXXX____IIIIMMMMAAAAGGGGEEEE____SSSSGGGGIIIIXXXX.
  454.  
  455. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  456.      ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  457.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                                                                         PPPPaaaaggggeeee 7777
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  471.  
  472.  
  473.  
  474. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  475.      The SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc and SSSSGGGGIIIIXXXX____aaaassssyyyynnnncccc____ppppiiiixxxxeeeellll extensions are implemented only on
  476.      OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems.
  477.  
  478.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems do not support color
  479.      matrix transformations on images as they are loaded to or read back from
  480.      texture memory.
  481.  
  482.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems do not support convolving
  483.      images as they are loaded into texture memory.
  484.  
  485.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems do not support histogram
  486.      or minmax operations on images as they are being loaded into texture
  487.      memory.
  488.  
  489.      The EEEEXXXXTTTT____ppppaaaacccckkkkeeeedddd____ppppiiiixxxxeeeellllssss extension is not supported on RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee,
  490.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems.
  491.  
  492.      On RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems:
  493.  
  494.           1.  The texture environment must be defined and texturing must be
  495.               enabled before loading a texture.
  496.  
  497.           2.  Texture formats composed only of alpha are not supported.
  498.  
  499.           3.  Borders are not supported; hence the border width must be 0.
  500.  
  501.           4.  Proxy textures are not supported.
  502.  
  503.           5.  ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD with a NULL texture image may not be used inside a
  504.               display list.
  505.  
  506.           6.  GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is not supported (see ggggllllEEEEnnnnaaaabbbblllleeee).
  507.  
  508.      On HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt systems the number of bits per
  509.      component, represented internally, is the same for all components and
  510.      will be 4, 8, or 12 bits per component. All specified internal formats
  511.      will receive an equal or greater representation in this scheme, up to the
  512.      12-bit limit.  HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Indigo2 systems do not
  513.      support texture internal formats of the type GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY or GGGGLLLL____AAAALLLLPPPPHHHHAAAA,
  514.      although HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Octane systems do support
  515.      these types.
  516.  
  517.      HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Indigo2 systems without the TRAM option
  518.      card support 4 bits per component for GGGGLLLL____RRRRGGGGBBBB and GGGGLLLL____RRRRGGGGBBBBAAAA, 4/8 bits per
  519.      component for GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, and 4/8/12 bits per component for
  520.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE.
  521.  
  522.      Texture borders are not supported on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems, so the
  523.      border width should always be zero.  Applications should use the texture
  524.      wrap mode GGGGLLLL____CCCCLLLLAAAAMMMMPPPP____TTTTOOOO____EEEEDDDDGGGGEEEE____SSSSGGGGIIIISSSS to obtain behavior similar to that of
  525.      borders.
  526.  
  527.  
  528.  
  529.                                                                         PPPPaaaaggggeeee 8888
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536. ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD((((3333GGGG))))
  537.  
  538.  
  539.  
  540.      The SSSSGGGGIIIISSSS____tttteeeexxxxttttuuuurrrreeee____sssseeeelllleeeecccctttt extension is supported only on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy
  541.      systems, HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Octane systems, and HHHHiiiigggghhhh
  542.      IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Indigo2 systems with the TRAM option card.
  543.  
  544.      On IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems, HHHHiiiigggghhhh
  545.      IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt systems, and OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems, texture
  546.      objects (see ggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeeeEEEEXXXXTTTT) are significantly faster than display-
  547.      listed textures, and therefore are recommended for managing texture
  548.      memory.
  549.  
  550.  
  551. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  552.      ggggllllCCCCoooolllloooorrrrTTTTaaaabbbblllleeee, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDD, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
  553.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD,
  554.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllMMMMaaaattttrrrriiiixxxxMMMMooooddddeeee, ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee,
  555.      ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ggggllllTTTTeeeexxxxEEEEnnnnvvvv, ggggllllTTTTeeeexxxxGGGGeeeennnn, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD,
  556.      ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr,
  557.      ggggllllAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX, ggggllllDDDDeeeelllleeeetttteeeeAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX, ggggllllFFFFiiiinnnniiiisssshhhhAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX,
  558.      ggggllllGGGGeeeennnnAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrssssSSSSGGGGIIIIXXXX, ggggllllIIIIssssAAAAssssyyyynnnnccccMMMMaaaarrrrkkkkeeeerrrrSSSSGGGGIIIIXXXX, ggggllllPPPPoooollllllllAAAAssssyyyynnnnccccSSSSGGGGIIIIXXXX
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                                                         PPPPaaaaggggeeee 9999
  596.  
  597.  
  598.  
  599.